home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / maximus / dlc_243.zip / DLC.DOC < prev    next >
Text File  |  1992-08-26  |  12KB  |  284 lines
  1. DLC.EXE v2.43 - A Maximus-CBCS v2.00 download counter
  2. Copyright (C) 1991, 1992 Robert Presland, all rights reserved.
  3.  
  4. [ Release Info * 26 Aug 92 ]---------------------------------------------------
  5.  
  6. Release 2.21 and greater are major upgrades from previous releases, therefore
  7. you should read this file before using.  Previous releases were under the
  8. name DLCOUNT but since a utility already existed by that name, mine was
  9. changed to DLC.
  10.  
  11. This version uses a control file for it's parameters (you can only fit
  12. so much on a command line).  Please consult the distribution control
  13. file DLC.CTL for more details.
  14.  
  15. Refer to WHATS.NEW for the latest info for this release.
  16.  
  17. [ Bug Reports ]----------------------------------------------------------------
  18.  
  19. Send bug reports to Robert Presland at 1:243/27, include the following:
  20.  
  21.    DLC.CTL
  22.    DLC.LOG
  23.    DLC.TMP (if found in the current directory)
  24.    AREA.DAT (or equivalent)
  25.    MAX.LOG (or equivalent)
  26.    FD.LOG (if applicable)
  27.    BINK.LOG (if applicable)
  28.    FILES.BBS (if applicable)
  29.  
  30. Zip 'em up and send 'em off.  Many thanks to all that send me reports on
  31. my programs, it's a great help.  I welcome all comments and suggestions
  32. to the above node address.
  33.  
  34. [ So Why Use This Utility? ]---------------------------------------------------
  35.  
  36. DLC currently supports FILELIST for CD-ROM users, mailer logs, extension
  37. exclusions, configurable counter delimiters, optional download log file,
  38. optional log file, multiple configuration files, configurable length
  39. counters, optional 'space for zero' counter, selective initialization,
  40. and will not process the same downloaded file more than once, as well as
  41. much much more.  Read the history section for a complete detailing of
  42. what has been added since the first release.
  43.  
  44. [ Archive ]--------------------------------------------------------------------
  45.  
  46. You should have received DLC in an ARJ archive, with only the following
  47. six (6) files contained within:
  48.  
  49.      DLC.DOC      This text file
  50.      DLC.EXE      The exectuable
  51.      DLCTT.DOC    Documentation for DLCTT
  52.      DLCTT.EXE    The DLCTT executable
  53.      DLC.CTL      The control file for both DLC and DLCTT
  54.      UPGRADE.DOC  New things you must know about
  55.  
  56. If one of these files is missing, or there are extra files, or the archive
  57. fails a CRC check, please file-request it from 1:243/27.
  58.  
  59. [ Description ]----------------------------------------------------------------
  60.  
  61. DLC will process your Max log file and add a counter to the beginning
  62. of the description for each file downloaded.  A four digit counter is used
  63. (by default) to enable up to 9999 downloads per file, however, since the 
  64. counter length is configurable, you could get counters in the 65000 range
  65. if you wanted.
  66.  
  67. [ Installation ]---------------------------------------------------------------
  68.  
  69. Simply run DLC as part of your daily maintenace (usually at midnight) and
  70. make sure you configure the control file to suit your system.  After that,
  71. it's all automatic.  Do whatever you want with the logs after DLC is done.
  72.  
  73. [ Usage ]----------------------------------------------------------------------
  74.  
  75.    DLC [ /?] [/Q] [/F] [/U] [/S] [/C<ConfigFile>] [/I [Areas]] [/A [Areas]]
  76.  
  77. [ Switches ]-------------------------------------------------------------------
  78.  
  79.    /?
  80.  
  81.       Display a help screen.
  82.  
  83.    /Q
  84.  
  85.       Quiet mode, no screen log echos (but still a brief progress note).
  86.  
  87.    /F
  88.  
  89.       Process all downloads in the BBS and mailer logs even if they have
  90.       been processed already.
  91.  
  92.    /U
  93.  
  94.       Initalizes all areas which allow uploads, however no log parsing is
  95.       performed.  You could use this switch after each upload to your
  96.       system.
  97.  
  98.    /S
  99.  
  100.       Create a stat file for use with the accompanying program DLCTT.
  101.  
  102.    /I [Areas]
  103.  
  104.       DLC will add a zero count to every file without a count located in
  105.       either the file FILES.BBS in the DOWNLOAD directory, or the file
  106.       specified in the FILELIST option.  If a counter does not exist, one
  107.       will be added.  This is NOT a reset for counters.  If just /I is
  108.       used, then all areas will be initalized.  If a list of area
  109.       names is also specified, then only those areas will be initialized.
  110.       When this switch is used, only the initialization will be done
  111.       and the log files (both BBS and Mailer) will NOT be parsed.
  112.       THIS SWITCH IF SPECIFIED MUST BE THE LAST SWITCH ON THE COMMAND LINE!
  113.  
  114.       For example:
  115.  
  116.          DLC /I                Initialize all areas
  117.          DLC /I 47             Initialize the area 47
  118.          DLC /I DOS GRAPHICS   Initialize the areas DOS and GRAPHICS
  119.     
  120.    /A [Areas]
  121.  
  122.       Same as /I except DLC will also parse the mailer logs.
  123.       THIS SWITCH IF SPECIFIED MUST BE THE LAST SWITCH ON THE COMMAND LINE!
  124.  
  125.    /C<ConfigFile>
  126.  
  127.       The default control file is DLC.CTL, but you can specify an alternate
  128.       control file with this switch.
  129.  
  130. [ History ]--------------------------------------------------------------------
  131.  
  132. 2.43  Added multiple area intialization through /I and /A.
  133.  
  134. 2.42  A little optimization (I tried).  Fixed a bug when assuming data in
  135.       the AREA.DAT file was in parsed format.
  136.  
  137. 2.41  Added 'ProcessGif' and 'GifTemplate' to control file.  See the
  138.       distribution control file for more details.
  139.  
  140. 2.40  Added support for Max's AREA.DAT file.  Reviewed log levels and
  141.       log entries.  Added ": Read x file area(s)" to log.  Added file sharing,
  142.       files are opened in ReadOnly and DenyNone for reading.  DLC will
  143.       now read all areas into memory from AREA.DAT file, maximum 1024
  144.       areas memory permitting.  If DLC can't fit all the areas into memory
  145.       then the remaining areas will just be treated as if they didn't exist.
  146.       Updated DLCTT, see its documentation for more details.
  147.  
  148. 2.33  Fixed a small bug that would occasionaly miss initializing a file
  149.       if it had no description.  Fixed a runtime error when not using /S.
  150.  
  151. 2.32  Added /S and DLCTT.  Deleted beta release notice in docs.  Added
  152.       accompanying utility DLCTT.  See DLCTT.DOC for more details.
  153.  
  154. 2.31  Fixed a bug which would process the same file more than once in
  155.       the mailer log.
  156.  
  157. 2.30  Full wide release in SDSMAX.
  158.  
  159. 2.29r Maximum file areas is now 435 instead of 400.
  160.  
  161. 2.29q DLC will now ignore any QW? extensions automagically.
  162.  
  163. 2.29p Ok, listen up!  You can now use the - any where you want and what
  164.       is suppose to happen is most likely what may happen.  That is,
  165.       You can use the - in a filename within the FILES.BBS and you can
  166.       use a - in the path of a download area.  And you can use the - as
  167.       a colour indicator as the first character in the FILES.BBS.
  168.       Happy now?
  169.  
  170. 2.29o Another one that looks funny.
  171.  
  172. 2.29n Added - back as a "no-no" character for file names and full
  173.       paths.  - is necessary as a colour control character in the 
  174.       FILES.BBS.  Sorry Ken.  Fixed 'IgnoreFilesWithTic' which never
  175.       did work.
  176.  
  177. 2.29m Improved update performance with a little optimization.  Removed
  178.       the - character from the list of "no-no" characters (I was saving
  179.       it for future switches in the files' description but too many
  180.       want it in the filename and area paths, so now you can).
  181.  
  182. 2.29l There is none, 2.29l looks funny.
  183.  
  184. 2.29k Fixed *MAJOR* bug introduced with 2.29j that would truncate the
  185.       FILES.BBS (or equivalent) after a match is found.  Fixed a small
  186.       bug with the display of the +End log line when /? is used.
  187.  
  188. 2.29j Will exit the current FILES.BBS (or equivalent) as soon as a match
  189.       is found and will *not* search and update dups in the list.
  190.  
  191. 2.29i Fixed a bug that would update a file more than once if more than
  192.       one file area pointed to the same directory.  Sorted areas in memory
  193.       for faster searching.
  194.  
  195. 2.29h Screen writes are now BIOS and not direct, fixed a spelling error
  196.       in the help screen.  Fixed a couple of misplaced file close calls.
  197.       Echo log entries to screen, added /Q for quiet mode.
  198.  
  199. 2.29g Added 'IgnoreFilesWithTic' to allow files that were transferred as
  200.       part of a TIC process to not be counted.  
  201.  
  202. 2.29f Allowed all characters except /-[<{( as the first character of
  203.       a file's description without a counter.  Added /F, forced log
  204.       parsing.
  205.  
  206. 2.29e Added full DOS wildcard matching within FILES.BBS (or equivalent).
  207.       
  208. 2.29d Fixed a bug when the DLC log file directory didn't exist, will now
  209.       catch the error and exit gracefully.  Modified /I to not parse
  210.       log files.  Added /A to initialize AND parse.  Added /U to initialize
  211.       only the upload areas (without log parsing).  Altered the way that DLC
  212.       determines if there is a counter already present.  Now, DLC will check
  213.       to see if a counter is present where it would put one, and not anywhere
  214.       in the line.  This will permit the use of [] (etc) as part of the
  215.       files' description (but not as the first character in the description).
  216.  
  217. 2.29c Fixed a bug when inserting new counters, it would add 3 extra spaces
  218.       when not wanted.
  219.  
  220. 2.29b Added selective area initialization, zero-padded as an option to
  221.       space-padding.  Fixed a bug while reading tab characters.
  222.       Limited beta release.
  223.  
  224. 2.29a Added optional [    ] instead of [   0] for a zero counter.  The 
  225.       length of the counter is now configurable.  DLC will read the current
  226.       counter for a file, update it, and not change the length.  When
  227.       adding a new counter however, DLC will add one in accordance to the
  228.       control file specification for counter length.  Limited beta release.
  229.  
  230. 2.23  Fixed a minor bug which still diplayed an error to the screen when
  231.       the specified FILES.BBS file is not found.  Fixed a bug with lower-
  232.       case specified IgnoreExt.  Added 'AddOrphan' keyword to the control
  233.       file.  Added support for wildcard matching in the FILES.BBS.  Added
  234.       support for same file BBS/Mailer logs (ie. the BBS and Mailer use
  235.       the same log file).
  236.  
  237. 2.22  Fixed a bug that hung on mailer lines with SENT in BBS names,
  238.       took the same problem and fixed it in places that may cause problems
  239.       in similar situations on other log files.  Added support for all
  240.       valid DOS characters in filenames, ie. ~!@#$%&()_
  241.  
  242. 2.21  Fixed a bug that hung on lines with nothing but spaces.
  243.  
  244. 2.2   Added a check to ensure that the DLC will not process entries
  245.       in either the Maximus log file or the mailer log file more than
  246.       once.  This means that you can run DLC on the same log file more
  247.       than once and the downloads will only be counted once.  Added a
  248.       log file, including a log entry level.  Most of output is through
  249.       the log file and not the screen.  Released for testing only.
  250.  
  251. 2.1   Added mailer support, as well as the ability to ignore files
  252.       based on extension.  Changed from a command line configuration
  253.       to a control file configuration.  Name changed from DLCOUNT to
  254.       DLC to avoid copyright infringement.  Released for testing only.
  255.  
  256. 2.0   Rewrite of previous version with better algorithms.  File
  257.       area data is kept in memory and not in a temp file.  Support
  258.       for the FILELIST command in the FILEAREA.CTL was added.
  259.       Colour was an option but then abondoned (too annoying).
  260.       Released for testing only.
  261.  
  262. 1.3   First public release.
  263.  
  264. 1.0   Stone age thing not worth mentioning.
  265.  
  266. [ Warning! ]-------------------------------------------------------------------
  267.  
  268. This utility is not guaranteed to do anything.  Use at your own risk.
  269. Don't come crying to me!
  270.  
  271. [ Legal Stuff ]----------------------------------------------------------------
  272.  
  273. This utility may be distributed in it's original archive only.  No fee shall
  274. be charged for its distribution beyond the cost of transmition over phone
  275. lines.
  276.  
  277. [ Thanks ]---------------------------------------------------------------------
  278.  
  279. Much thanks to Chris Grainger (1:163/518) for his help in testing and
  280. support.  Thanks to Ken Wilson (1:243/12) for picking up DLC and 
  281. proposing many excellent suggestions and endless hours of testing.
  282. Many thanks to all those who use this utility and respond with complaints,
  283. comments and suggestions.
  284.